home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / grap_cad / acdb / acdb.doc next >
Text File  |  1993-01-22  |  23KB  |  491 lines

  1.  
  2.  
  3.  
  4.      
  5.                                     A C D B
  6.                                     
  7.                                 AutoCAD DataBase                  
  8.                                   
  9.                            User-supported software by      
  10.                            
  11.                                  Norman  Newman
  12.                                  Kibbutz Tsor'a
  13.                                  M.P.  Shimshon
  14.                                  ISRAEL   99705
  15.  
  16.  
  17.  
  18.                  ┌───────────────────────────────────────────┐
  19.                  │                                           │
  20.                  │ Runs on all IBM-compatible computers: XT, │
  21.                  │ AT, PS/1, PS/2. Requires DOS 3.0 and one  │
  22.                  │ 360K drive. 640K memory recommended.      │
  23.                  │                                           │
  24.                  └───────────────────────────────────────────┘
  25.  
  26. Legal note
  27. ----------
  28. This program is copyright 1992/3 by Norman Newman, Kibbutz Tsor'a, M.P.
  29. Shimshon, ISRAEL 99705; all rights reserved, all wrongs deserved.  The
  30. program may be freely distributed and copied, provided that no changes are
  31. made in either ACDB.EXE or ACDB.DOC (this file). The author denies all
  32. responsibility for any damage caused by the use or misuse of this program.
  33.  
  34. This software is provided as shareware. This means that you have the
  35. opportunity to try ACDB before having to register. Should you decide to
  36. keep and use this program, you are requested to register your copy with the
  37. author by sending a cheque for $35. This will entitle you to receive a new
  38. copy of the program without the shareware screen at the beginning, which
  39. is capable of 'launching' (executing) a program from within, and which is
  40. capable of communicating with AutoCAD, as well as free support and updates 
  41. for one year.
  42.  
  43. This program is "user-driven" and suggestions for additional features are
  44. welcome. This documentation describes version 1.2, which is the current
  45. released version (1/93).
  46.  
  47. What is the AutoCAD DataBase (ACDB)?
  48. ------------------------------------
  49. ACDB is a program designed to maintain a database of drawing files, created
  50. by the AutoCAD program (AutoCAD is a trademark of AutoDesk Ltd), although
  51. it can easily be used with other CAD programs. Some of ACDB's features are:
  52.  
  53.   * Record sorting by several fields
  54.   
  55.   * Viewing the stored data and the drawing itself on one screen
  56.   
  57.   * Launching AutoCAD from within the program
  58.  
  59.   * If ACDB is launched from within AutoCAD, it will automatically display
  60.     the chosen file in AutoCAD.
  61.     
  62. ACDB was written with the aid of Borland's Turbo Vision programming
  63. interface, which supports an implementation of IBM's SAA-CUA (Systems
  64. Application Architecture - Common User Access) standard, which has been
  65. used in several programs and supports a common user interface, with such
  66. devices as dialog boxes, list boxes and scroll bars. ACDB supports a mouse.
  67.  
  68.  
  69. Installation
  70. ------------
  71. Your distribution diskette should contain the following files:
  72.          ACDB.EXE
  73.          ACDB.DOC
  74.          TVPRINT.DAT 
  75.          
  76. If you have a floppy drive system, prepare a newly formatted diskette, and
  77. copy all three files onto this diskette. If you have a computer with a hard
  78. disk, create a new subdirectory and copy the files into this subdirectory.
  79.  
  80. ACDB looks for its data files (called ACDB.DAT and ACDB.CFG) in the current
  81. directory, and if no file is found, a new file will be created when ACDB
  82. finishes executing. You can maintain several databases concurrently by
  83. executing ACDB from different subdirectories.
  84.  
  85. Registered users will also receive the file ACDB.LSP. It is suggested that
  86. this file (which contains the 'acdb' command) be added to your ACAD.LSP
  87. file in the following matter:
  88.  
  89.   copy acad.lsp + acdb.lsp acad.lsp
  90.   
  91. This will ensure that the 'acdb' command is always available to you within
  92. AutoCAD.
  93.   
  94. The file TVPRINT.DAT contains information about different printers, and may
  95. be seen as a system-wide resource which is used by several programs written
  96. by the author. This file may optionally reside within the same directory as
  97. the ACDB files (this is recommended if you are NOT using other programs
  98. written by the author), or in a separate directory. If you intend to do
  99. this, you must add to your AUTOEXEC.BAT file the line SET TVPRINT=C:\ACDB
  100. (replace C:\ACDB with the name of the directory where the file TVPRINT.DAT
  101. will reside; leave no spaces on either side of the equals sign). This
  102. creates an 'environmental variable' called TVPRINT, which says where the
  103. printer database can be found. Programs such as ACDB can acquire the value
  104. of this variable and so access the printer database.
  105.  
  106.  
  107. Program Invocation
  108. ------------------
  109. One invokes the program by simply typing 'ACDB' at the DOS command line. If
  110. you have the registered version of the program and intend to run it within
  111. another program, invoke the program by typing 'ACDB /F' (this is done
  112. automatically by the 'acdb' command in AutoCAD).
  113.  
  114. Should you have a non-registered version of the program, you will initially
  115. receive what is termed 'the shareware screen': this screen informs you of
  116. the program's name, who wrote it, and what the terms for registration are.
  117. In order to continue, simply type in the number that will be displayed.
  118. Note that this number is random, and so will not be the same from
  119. invocation to invocation.
  120.  
  121. The main screen can be divided into three parts: the bottom line is called
  122. the status line, the top line is called the menu bar, and the middle
  123. portion (coloured blue on a colour screen) is the workspace.
  124.  
  125. On the status line appear four different items. The first two inform
  126. you of general commands: pressing <F10> will make the menu bar active, and
  127. pressing <Alt-X> will stop the program running and return you to DOS. The
  128. next item on the status line is called 'the hint'; this will either be a
  129. hint on how to operate the dialog box which is on the screen, or will be a
  130. copyright notice. When you start the program, there is no dialog box on the
  131. screen, and so the hint will be the copyright notice. The final item on the
  132. status line is a clock; its accuracy depends on the accuracy of your
  133. computer's clock.
  134.  
  135. The menu bar has three visible options: 'Drawings', 'Reports', and
  136. 'General'.  Note that the first letter of each option is coloured red.
  137. There are three equivalent ways to choose one of these options: 
  138.  
  139.   a) move the mouse pointer over the desired option and press the left mouse 
  140.      button; 
  141.   b) press <F10> to take the cursor to the menu bar, which will highlight
  142.      Drawings (on a colour screen, this will be green); press the arrow keys
  143.      until the highlight is on the desired option, and then press <ENTER>; 
  144.   c) press <Alt-key>, where 'key' is the red (first) character in each option
  145.      (eg <Alt-D> - pressing <ALT> and <D> simultaneously - will select
  146.      'Drawings').
  147.  
  148. After you have selected an option, a pull-down menu will appear underneath
  149. the selected option, allowing access to several sub-options.  You can
  150. choose one of these sub-options again in any one of three ways: by using
  151. the mouse as above, by moving the green highlight with the arrow keys and
  152. pressing <ENTER> when the desired sub-option is lit, or by pressing the red
  153. (first) character (no need for <Alt>!). 
  154.  
  155. In all stages of the program (except the main menu), you can cancel the
  156. current option by pressing Escape, by clicking the mouse or pressing Enter
  157. on the 'Cancel' button (if there is one), or by clicking the mouse on the
  158. 'close' box (the little green box in the top left hand corner of the dialog
  159. box frame). 
  160.  
  161. This document will often refer to 'drawings'; within the confines of ACDB,
  162. a drawing means a record contained within the database which contains data
  163. regarding a drawing file (with extension *.DWG), and not the drawing itself.
  164.  
  165. DRAWINGS
  166. ========
  167. In this section are four program options which relate to specific drawings.
  168.  
  169. Add a drawing
  170. -------------
  171. Upon choosing this option, a list box will open, displaying all the files
  172. whose path and name (eg c:\acad\acad.dwg) match the default values, as
  173. defined in the Configure option. Initially, this value will be '*.dwg', but
  174. should ACDB and (for example) AutoCAD be in different directories, you will
  175. have to change this default directory to show exactly where the drawing
  176. files are (eg 'C:\ACAD\*.DWG').
  177.  
  178. Note that you can only enter into ACDB's database drawings which physically
  179. exist. 
  180.  
  181. You can scroll through the filenames with the arrow keys or by dragging on
  182. the scrollbar with the mouse. In order to select a drawing, press Enter (or
  183. double click on the mouse) to choose the drawing whose name will be
  184. highlit, or press Escape to exit the option.
  185.  
  186. Assuming that you have chosen a file, the file dialog box will disappear,
  187. and a new dialog box will open on the screen. If you have chosen the name
  188. of a drawing which does not appear in ACDB's database, the dialog box will be
  189. empty; otherwise the data stored regarding the chosen drawing will be
  190. retrieved and disposed in the dialog box.
  191.  
  192. The data which you can store regarding each drawing are:
  193.  
  194.  + Client - for whom the drawing was made
  195.  + Product - the name of the product (the drawing may be part of a larger
  196.              product)
  197.  + Salesman - the name of the salesman responsible
  198.  + Comments - any other remarks
  199.  + Drawing/Block - whether the file is a complete drawing or a block
  200.  
  201. The first four fields are alphanumeric text strings, each upto 40
  202. characters long. In order to save typing, you can press F2 (or click on the
  203. right mouse button) when on any of the first three lines, in which case
  204. ACDB will open a small window listing all the clients/products/salesmen
  205. which have been entered into the database. You can choose one of these by
  206. scrolling through the list and pressing Enter; pressing Escape will close
  207. the window without selecting any name.
  208.  
  209. You can move forward through the dialog box by pressing Tab, and backward
  210. by pressing Shift-Tab. You can jump to different fields by pressing Alt and
  211. the highlit letter in each field (eg Alt-C will jump to the client field),
  212. or by clicking the mouse on the desired field.
  213.  
  214. If you are satisfied with the data you have entered, 'press' on the OK
  215. button (by clicking the mouse on it, by pressing Alt-O, or by tabbing to
  216. the OK button and pressing Enter), which will cause the data to be added to
  217. the database. Should you wish not to keep the data, press Escape or click
  218. on the Cancel button.
  219.  
  220. In the right hand corner of the menu bar appears the number of drawings
  221. within the database; note how the number increases when you add a new
  222. drawing.
  223.  
  224. Edit a drawing
  225. --------------
  226. This option allows you to edit data which you have already stored regarding
  227. a specific drawing. Upon choosing this option, you will be presented with a
  228. list of drawings which already exist within the database; you can choose a
  229. drawing by scrolling through the list with the up- and down-arrows keys,
  230. and then by pressing <ENTER>. If you prefer to use a mouse, 'drag' the box
  231. on the scrollbar (the line on the right hand side of the list box) until
  232. the desired drawing is displayed, and then double click the left button on
  233. the name of the drawing.
  234.  
  235. The same dialog box as described in the previous section will be displayed,
  236. but instead of being empty, the data regarding the chosen drawing will be
  237. displayed. Should you press on the OK button, the original data will be
  238. discarded and the new data will be stored.
  239.  
  240. Display a drawing
  241. -----------------
  242. Upon choosing this option, you will be presented with a list of drawings
  243. which already exist within the database; you can choose a drawing by
  244. scrolling through the list with the up- and down-arrows keys. Should you
  245. wish not to display a drawing, press <Escape>; otherwise press <Enter> or
  246. double click with the left mouse button on the desired drawing.
  247.  
  248. Assuming that you have chosen a drawing, ACDB will look for a slide file
  249. with the same complete name (that is, including the path name which ACDB
  250. stores but does not display in the list box), but with the .SLD extension
  251. (ie if you have chosen AIRPLANE.DWG, ACDB will look for the file
  252. AIRPLANE.SLD). Should such a file be found, ACDB will both display the data
  253. stored regarding this file and draw the drawing. SLD files are created
  254. within AutoCAD with the 'mslide' command. In order to return to the file
  255. list box, you must press a key (it doesn't matter which); clicking the
  256. mouse has no effect.
  257.  
  258. If no SLD file can be found, only the data regarding the file will be
  259. displayed.
  260.  
  261. Remove a drawing
  262. ----------------
  263. Again you will be presented with the list of drawings within the database;
  264. choosing a drawing will cause a dialog box to appear, asking you to confirm
  265. that you wish to delete the drawing from the database. Should you press the
  266. 'Yes' button, the drawing will be deleted from the database, and the
  267. drawings count (appearing in the top right hand corner of the screen) will
  268. decrease by one.
  269.  
  270. It is important to remember that deleting a 'drawing' from the database in
  271. no way affects the actual drawing file stored on disk.
  272.  
  273. REPORTS
  274. =======
  275. In this section are contained options which will enable you to display the
  276. data contained in the database according to different criteria. The first
  277. option ('Show by client') allows you to display drawings belonging to the
  278. chosen client(s). The second option allows you to display drawings
  279. belonging to the chosen range of products, and the third allows you to
  280. display drawings belonging to the chosen salesman/salesmen. As these three
  281. options are basically the same, differing only in the sort criterion, only
  282. the 'sort by client' option will be documented here.
  283.  
  284. Choosing this option will cause a dialog box to be displayed, in which you
  285. can choose where to send the output - to the screen, to the printer or to a
  286. file.
  287.  
  288. After this will appear another dialog box, asking for the range of values;
  289. the initial 'from' value will be the first client in the database (by
  290. alphabetical order), and the initial 'to' value will be the last client.
  291. These values can be changed by either typing on the the input lines, or by
  292. pressing <F2> to display a list box containing clients' names. You choose a
  293. name by scrolling and pressing <ENTER>.
  294.  
  295. If you have chosen to display the drawings ordered by the client(s) on the
  296. screen, a large list box will appear, listing each drawing's number, client
  297. and name. In order to obtain further data, scroll through this list and
  298. press <ENTER> on a specific drawing; the data regarding this drawing will
  299. be displayed as in the section "Display a drawing" described before. Slide
  300. files are not drawn by this option.
  301.  
  302. If you have chosen to print to a file, you will be prompted for a file into
  303. which to write the data. Writing to a file and writing to the printer cause
  304. all the data regarding the drawings ordered by the chosen client(s) to be
  305. printed.
  306.  
  307. GENERAL
  308. =======
  309. In this section are four options which relate to the database as a whole,
  310. or which do not fit into the previous sections.
  311.  
  312. Launch a drawing
  313. ----------------
  314. This option exists only in the registered version of the program;
  315. non-registered users will receive a message telling them to register,
  316. should they choose this option.
  317.  
  318. Initially you will be presented with the list of drawings stored in the
  319. database; you can scroll through the list with the arrow keys. To execute
  320. AutoCAD with a specific drawing, simply press Enter (or double click the
  321. left mouse button) when the desired file is highlit.  Pressing Escape will
  322. return the program to the main menu.
  323.  
  324. If you are running ACDB within AutoCAD and executed the program with the
  325. 'acdb' command, ACDB will create a file (called C:\ACDB.$$$) which contains
  326. the name of the drawing which you have chosen. This name is passed to
  327. AutoCAD, and the drawing selected is then drawn.
  328.  
  329. If you are running ACDB directly from DOS, you must tell ACDB which program
  330. to execute by entering its name in the configuration section. For AutoCAD,
  331. this will normally be a batch file called ACAD.BAT or ACAD386.BAT.  Should
  332. you wish to execute a different program, change the value in the
  333. configuration section.
  334.  
  335. Update/weed
  336. -----------
  337. This option checks all the drawings in the database and updates their size
  338. and 'last accessed' dates. If a drawing exists in the database, but the
  339. corresponding file no longer exists, ACDB will ask you whether to delete
  340. the drawing.
  341.  
  342. Configure
  343. ---------
  344. Choosing this option will display a dialog box which enables you to modify
  345. ACDB's behaviour. The dialog box consists of four lines: the first is the
  346. default file type to look for when adding files (see 'Add a file'), the
  347. second is the name of the program to execute (see 'Launch file'), the third
  348. is the type of printer that you are using, and the fourth controls how
  349. often the program will automatically save your data.
  350.  
  351. The default values of these fields are '*.DWG' - select all drawing files
  352. in the current directory, 'C:\ACAD.BAT' - execute this batch file with the
  353. chosen drawing file, 'Epson' - use an Epson printer, and '5' - save after
  354. five changes.. Should you choose to use ACDB with a different target
  355. program, you should adjust these values accordingly. If you run ACDB in one
  356. directory but keep your DWG files in another directory, it is worthwhile to
  357. add the directory name to the default file name - e.g.  C:\ACAD\*.DWG.
  358.  
  359. Pressing Enter will cause the data in the dialog box to be stored in the
  360. file ACDB.CFG. As with the data file (ACDB.DAT), this file will be created
  361. in the current directory, and so it is possible to maintain multiple
  362. configurations in different directories.
  363.  
  364. One example of multiple configurations is to maintain one database of
  365. AutoCAD drawings (default values C:\ACAD\*.DWG and C:\ACAD.BAT), and
  366. another database of letters and articles (default values C:\LETTERS\*.TXT
  367. and C:\NORTON\NE.COM). Obviously the field names will not completely match
  368. the secondary application, but this problem can be overcome with a little
  369. imagination. 
  370.  
  371. The printer name is needed only to determine how many lines to print on a
  372. page. Most continuous feed printers have 66 lines on a page, but single
  373. sheet printers can print only 55 lines. In order to install your printer,
  374. press <F1>; a window will open displaying names of printers contained in
  375. the printer database. You can choosing a printer by scrolling and pressing
  376. <ENTER>; <F1> will allow you to add a new printer to the database, and <F2>
  377. will allow you to edit the information contained in the printer database
  378. about the chosen printer.
  379.  
  380. Should you decide to add or edit a printer, a dialog box will appear asking
  381. for escape sequences to print normal and compressed print (16 character per
  382. inch), to eject a page, and how many lines there are on a page. As
  383. mentioned earlier, ACDB only uses the number of lines on a page.
  384.  
  385. The printer database is maintained on a system wide basis, so that many
  386. programs can use it. Add to your AUTOEXEC.BAT file the line
  387. SET TVPRINT=C:\ACDB
  388. (replace C:\ACDB with the name of the directory where the file TVPRINT.DAT
  389. will reside). This creates an 'environmental variable' called TVPRINT,
  390. which says where the printer database can be found. Programs such as ACDB
  391. can acquire the value of this variable and so access the database.
  392.  
  393. Show totals
  394. -----------
  395. This option is for the inquisitive: it opens a window displaying statistics
  396. regarding the database, namely how many drawings, clients, products and
  397. salesmen have been defined; how much free memory exists, and how many more
  398. drawings can be entered (accept this number with a grain of salt).
  399.  
  400.  
  401.  
  402.  
  403. ADVERTISEMENT
  404. =============
  405.  
  406. Other shareware programs written by Norman Newman:
  407.  
  408. 8PUZZLE: this program reproduces the puzzle of eight numbered blocks and
  409.          one empty space in a 3 x 3 grid.
  410.  
  411.          "...In the last version we complained about the method of moving
  412.          the blocks. This has been fixed. You can also save and reload games, 
  413.          ask for hints and more." PsL News, November 1989.
  414.  
  415. AMATEUR: an expert system shell.
  416.  
  417.     "Is an expert system shell that is small, simple yet effective." PsL
  418.     News, December 1988.
  419.  
  420. BIGBEN: a TSR program which emulates the Big Ben clock in London by chiming 
  421.         every 15 minutes, and ringing the hour on the hour.
  422.  
  423. EXHUME: exhumes data lost on a damaged disk.
  424.  
  425.     "Will rescue (or "exhume") data which have been lost on a disk after the
  426.     directory or FATS have been corrupted." PsL News, October 1990.
  427.  
  428. HYPER: a simple hypertext implementation.
  429.  
  430.     "[HyperSee] displays in a hypertext format ASCII text files created with
  431.     any text editor or word processor which will save in straight ASCII. We
  432.     like HyperSee because it is extremely simple, yet it works. It does not
  433.     support graphics, but for a text-based system, it has the advantage of
  434.     being small enough (17K) to include on shareware disks for viewing
  435.     program documentation files." PsL News, February 1991.
  436.  
  437. INFER: a program to solve the hypothetical syllogism.
  438.  
  439. MAG: a database manager for magazine articles. Written primarily for computer
  440.      magazines, but can be used (with a little imagination) for other subjects.
  441.      
  442. SPEECH: speaks keystrokes through the Speech Thing (manufactured by Covox
  443.         Inc). A must for vision-impaired users.
  444.  
  445. PASMAC: a TSR program which provides a several keyboard macros for Pascal
  446.         programmers. The sign-on message explains the use of the program.
  447.  
  448. THE IMPORT MANAGER: a sophisticated program which maintains a database
  449.       for an import/export business. Tracks orders across the high seas.
  450.       Manages payments (but you have to supply the money!).
  451.  
  452.  
  453. All these high quality programs will be yours when you register your copy
  454. of ACDB.
  455.  
  456.  
  457.  
  458.  
  459.                            REGISTRATION FORM FOR ACDB
  460.                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  461.  
  462.  
  463.     Name: ____________________________________________________
  464.  
  465.     Street:___________________________________________________
  466.  
  467.     City: __________________ State:________ Zip:____________
  468.  
  469.  
  470.     Computer Brand: ______________________ Model: ___________________
  471.  
  472.  
  473.     Where did you get your copy of ACDB?
  474.     Friend            [ ]
  475.     BBS               [ ]
  476.     Shareware library [ ]
  477.  
  478.  
  479.     Check here if you need a 3.5" disk [ ]
  480.  
  481.  
  482.     Amount to send:                         $ 35.00
  483.     Please make your check payable to: Norman Newman
  484.     and mail to:                      Kibbutz Tsor'a
  485.                                       M. P. Shimshon
  486.                                       ISRAEL   99705
  487.  
  488.  
  489.  
  490.     Comments:
  491.